<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  <meta http-equiv="Content-Style-Type" content="text/css">
  <title></title>
  <meta name="Generator" content="Cocoa HTML Writer">
  <meta name="CocoaVersion" content="949.54">
  <style type="text/css">
    p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; font: 26.0px Helvetica}
    p.p2 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica}
    p.p3 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; min-height: 14.0px}
    p.p4 {margin: 0.0px 0.0px 0.0px 49.0px; font: 12.0px Helvetica}
    p.p5 {margin: 0.0px 0.0px 0.0px 0.0px; text-align: center; font: 12.0px Helvetica}
    p.p6 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Times; min-height: 14.0px}
    span.s1 {color: #0000fa}
    span.s2 {color: #0000f8}
    span.Apple-tab-span {white-space:pre}
  </style>
</head>
<body>
<p class="p1"><b>cgen</b></p>
<p class="p2">a text-field for function table generation.</p>
<p class="p3"><br></p>
<p class="p2"><b>DESCRIPTION</b></p><br>
<p class="p2"><b>cgen</b> widget is a text-field allowing the user to enumerate a serie of values that will be used 
	to generate a Csound table. The table will be created with the Csound GEN routine defined after the flag
	 <b>-gen</b>. Note that a negative GEN number implies that the function is not rescaled between 0 and 1, 
	and maintains its original values. The size of the table is set using the <b>-size</b> flag (usually a power of 2). 
	The function table number is accessible in the orchestra with a variable named <i>givariable_name</i>. 
	The <b>-init</b> flag sets the initial numerical value of the popup menu. Popup menu colour can be set using 
	<b>-col</b> flag and a <a href="./colourArgs.html">colour argument</a>. The <b>cgen</b> appears in the lower left 
	corner of the interface in the order listed.<span class="Apple-converted-space"> </span></p>
<p class="p3"><br></p>
<p class="p2"><b>INTERFACE SYNTAX</b></p><br>
<p class="p2"><span class="Apple-tab-span">	</span><b>cgen</b></p>
<p class="p2"><b><span class="Apple-tab-span">	</span></b>(compulsory)</p>
<p class="p2"><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><b>variable_name</b> (mandatory, no spaces allowed)</p>
<p class="p2"><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><b>-label</b> <span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>Text showing in Cecilia slider pane (spaces allowed). Default value = '     '</p>
<p class="p2"><span class="Apple-tab-span">	</span>(optional)</p>
<p class="p2"><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><b>-init</b> <span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>Initial value (numerical list). Default value = 1</p>
<p class="p2"><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><b>-gen</b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>Csound generator used to create the table. Default = -2</p>
<p class="p2"><b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>-size</b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>Size of the table (in samples). Default = 8192</p>
<p class="p2"><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><b>-col</b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>Colour of the slider (see <a href="./colourArgs.html">Colour arguments</a>). A default colour is applied by Cecilia</p>
<p class="p2"><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><b>-help</b><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span>Text for tooltips (space allowed) Default value = '     '</p>
<p class="p3"><br></p>
<p class="p2"><b>ORCHESTRA SYNTAX</b></p>
<p class="p2"><b><span class="Apple-tab-span">	</span></b>asig oscil kamp, kfreq, <b><i>giWaveform</i></b></p>
<p class="p4"><i> </i></p>
<p class="p2"><b><i><span class="Apple-tab-span">	</span></i></b>where <b><i>giWaveform</i> </b>is a table containing a harmonic waveform created with the GEN10 routine</p>
<p class="p2"><span class="Apple-tab-span">	</span>(In this case, the user has to define the proportion of each harmonic in the text-field of a <b>cgen</b>)</p>
<p class="p3"><br></p>
<p class="p2"><b>EXAMPLES</b></p><br>
<p class="p2"><span class="Apple-tab-span">	</span><b>cgen </b>custom<b> -label </b>Custom<b> </b>wave<b> -gen </b>10<b> -size </b>8192<b> -init </b>1,0,0,.3,0,0,.2,0,.1,0,0,0,.05<b> -col </b>red</p>
<p class="p3"><br></p>
<p class="p3"><br></p>
<p class="p5">Return to <a href="./buildInterface.html">Building Cecilia's Interface</a> section</p>
<p class="p6"><br></p>
<p class="p3"><br></p>
</body>
</html>
